home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / others / makeu310 / makeupl.doc next >
Text File  |  1994-12-19  |  13KB  |  393 lines
  1. Doku zu MAKEUPL von Volker Keck @ BL
  2. ------------------------------------
  3.  
  4. Das Programm darf frei verteilt werden.
  5.  
  6. !Wer dies Programm einsetzt, macht dies auf eigene Gefahr. Es wird keine Haftung!
  7. !fr irgendwelche direkten oder indirekten Sch„den, die durch die Benutzung des !
  8. !Programms entstehen, bernommen                                                !
  9.  
  10.  
  11. Voraussetzung:
  12. ---------------
  13. TOS, Modem, Telefonanschluž, Connect und eine Mausbox (allerdings keine Quark)
  14.  
  15. Sinn des Ganzen:
  16. ----------------
  17.  
  18. Aus Mitschnitten einer Saugsession, oder den TIC-Files die aus dem Fido 
  19. kommen bzw von Schnulli bei SaugTausch geliefert werden, oder aber ber die 
  20. Eingabe per Hand „hnlich wie in der Maus wird ein Script erstellt, das den 
  21. Upload, das evtl. L”schen und Umbenennen von Files in die Maus automatisiert. 
  22. Das Programm gibt TIC-Files aus, so daž evtl. das Script nicht zum Einsatz 
  23. kommt, sondern man die Files einfach nach dem Erstellen samt TIC-Files mit 
  24. dem Tauschupload von Schnulli (wird es wohl auch in Zukunft in nur sehr 
  25. wenigen M„usen geben) uploaden kann.
  26.  
  27. Mit dem erstellten Script kann man in den ™PT, zug„ngliche GPTs oder an 
  28. mehrere User im PPT (hier muž die Eingabe mit @ XY erfolgen, damit dies als 
  29. PPT erkannt wird.) Files uploaden. Das Script fragt hoffentlich recht viele 
  30. Fehler ab, falls es hier Probleme gibt bitte ich um Nachricht, denn das ist 
  31. recht schwer zu testen.
  32.  
  33. Zus„tzlich ist es m”glich GPTs fremder M„use ber eine Tabelle (INF-File) in 
  34. GPT oder ™PT umzusetzen.
  35.  
  36. Installation:
  37. -------------
  38. In der MAKEUPL.INF-Datei mssen  die Pfade entsprechend  eingestellt  werden. 
  39. Weiterhin sind die Gruppenprgteile und die Umsetztabelle zu versorgen. Dies 
  40. ist allerdings optional.
  41.  
  42. Auch ist in diesem File die Zuordnung der Typen zu den entsprechenden 
  43. Indizes (z.B. 6 Packer) nach einer evtl. Žnderung in der Maus anzupassen.
  44.  
  45. Im INF-File sind auch die Funktionen fr das Script definiert und k”nnen ggf. 
  46. angepažt werden. In diesem Fall bitte ich um eine kurze Nachricht, damit ich 
  47. das im Orginal nachvollziehen kann.
  48.  
  49. In den INF.Dateien haben folgende Zeichen eine Funktion:
  50.  
  51.     ------   dient als Maske fr den folgenden Text.
  52.       #      leitet einen Kommentar ein.
  53.  
  54.  
  55. Kurz ein paar Worte zum Ablauf der ganzen Geschichte.
  56. -----------------------------------------------------
  57. Es gibt mehrere Wege um eine Uploadscript zu erstellen:
  58.  
  59. 1. Es gibt im Verzeichnis ARCHIV.UPL ein gleichnamiges File mit Ausnahme des 
  60.    Suffix zu  einem bestimmten Archiv.  Also z.B.  heižt das Archiv 
  61.    MAKEUPL.ZIP dann  wird nach  einem  File  namens  MAKEUPL.TIC bzw. 
  62.    MAKEUPL.UPL  gesucht.  Aus  diesem  File  werden  die notwendigen Daten 
  63.    entnommen.
  64.  
  65.    Aufbau des UPL-Files
  66.    
  67.    1. Zeile: PT: Programmteil            z.B.: ™ffentlich
  68.    2. Zeile: BS: Betriebssystem          z.B.: ST-TOS
  69.    3. Zeile: Typ,Quelltext, Copyright    z.B.: Datenfernbertragung,C,Freeware
  70.    n. Zeile: Beschreibung max. 75 Zeichen je Zeile
  71.  
  72.    Dieser Aufbau entspricht dem der ausfhrlichen Liste in der Maus.
  73.  
  74.    Aufbau des TIC-Files siehe Anhang
  75.    
  76. 2. Es existiert ein Logfile vom Download:
  77.    Mit dem Program MAKEUPL.TOS kann dann ein Script fr den Upload erstellt 
  78.    werden. Dieses Logfile darf keine Steuerzeichen wie Escapes oder „hnliches 
  79.    enthalten. Dieses Logfile muž sich im "Logfile-Directory"  befinden. Es 
  80.    wird nach dem File  gesucht und die Daten wie Betriebssystem,  Typ,  etc. 
  81.    in das Script bernommen.
  82.  
  83. 3. Es existiert kein Logfile:
  84.    Hier fragt das Programm MAKEUPL.TTP die einzelnen Werte ab. Es werden wie 
  85.    bei einem Online-Upload  die  einzelnen Punkte (Betriebssystem,Type,usw.) 
  86.    abgefragt.
  87.  
  88. In allen drei F„llen wird dann ein neues *.TIC-File geschrieben.
  89. Das erstellte Script wird im Script-Ordner abgelegt.
  90.  
  91. In  der INF-Datei befindet sich noch der Punkt "Prg.-Liste der Maus".  Hier  
  92. sollte der  Ordnerpfad,  unter  der sich  die aktuellen Filelisten der 
  93. Hausmaus befinden eingestellt werden. Bei den Programml„ufen wird in dieser   
  94. Fileliste nachgeschaut, ob nicht schon evtl. das File in die Maus gelegt 
  95. worden ist. Dies fhrt je nach Einstellung zum berlesen des Files oder zu 
  96. einem Hinweis.
  97.  
  98. Nach dem Upload jedes Files, wird dieses sofort aus dem Archiv-Ordner  
  99. gel”scht.  Am Ende des Scripts wird dann das Programm erneut gestart und 
  100. somit  ein leeres Script erstellt.  Hier  wird  dem Programm der Parameter 
  101. "Online"  bergeben.  Damit  wird verhindert,  daž  w„hrend des Anrufs in der 
  102. Maus das Programm auf Eingaben  wartet. Fehlen in diesem Fall Daten, so 
  103. werden neutrale Werte eingesetzt. Damit drfte die Gefahr  eines  
  104. Doppeluploads weitgehend ausgeschložen sein. Das L”schen der Files wird von 
  105. DELETE.TTP erledigt.
  106.  
  107. Ist in der Maus bereits in File mit diesem Namen, so wird es vom Script 
  108. gel”scht. Darf nicht gel”scht werden, dann wird der Maus solange ein neuer 
  109. Filename geben, bis die Maus das File annimmt.
  110.  
  111. Das Script kann dann z.B. in das Pollscript eingebunden  werden. Das s„he 
  112. dann ungef„hr so aus:
  113.  
  114. ****************************
  115. ...
  116. mauswait 'Hauptmen'
  117.  
  118. . uplarch.scr       #  Da der Punkt ein CoSHy-Kommando darstellt,
  119.                     #  ist das Blank danach wichtig 
  120. neuedateien
  121. ...
  122. ****************************
  123.  
  124. So und nun noch ein paar Worte zu den Parametern und den TICFiles.
  125.  
  126. Vorgeschichte: 
  127.  
  128. Vom SaugTausch gibt es eine Liste in der alle gesaugten Prg hintereinander stehen. 
  129. Sie sieht aus wie die ausfhrliche Liste der Maus. Fr das mitgelieferte TIC-File 
  130. sieht es gleich aus - alles eine Wurst.
  131.  
  132. Das sollte man m”glichst in das ARCHIV.UPL Verzeichnis werfen k”nnen und das Prg. 
  133. macht den Rest. Gesagt getan.
  134.  
  135. Daher kennt das Prg jetzt zus„tzlich zum Parameter ONLINE noch ein paar weitere:
  136.  
  137. MAKETIC
  138. =======
  139.  
  140. Jedes File *.LST (kommt so vom Saugtausch oder aus einer ganz normalen ausf. 
  141. Prgliste der Maus) im ARCHIV.UPL wird gelesen und aus jedem Eintrag dort wird ein 
  142. TIC File erstellt.
  143.  
  144. CHECKTIC
  145. ========
  146.  
  147. Fr jedes *.TIC File in ARCHIV.UPL wird der richtige Name (im TIC steht File 
  148. ABC.ZIP das TIC heižt bis jetzt aber noch 94113012.12) vergeben. Sind in einem TIC 
  149. mehrere Archive beschreiben, dann wird das jetzt gesplittet.
  150.  
  151. CLEAR
  152. =====
  153.  
  154. Alle Files *.LST werden gel”scht und alle TIC Files deren Archiv es nicht gibt 
  155. (also im TIC steht etwas was nicht zum Upload da ist, z.b. alte TICs die nicht 
  156. gel”scht wurden) werden gel”scht.
  157.  
  158. MAKEUPL
  159. =======
  160.  
  161. Das Script wird erstellt und die TIC evtl. ge„ndert (z.B. bei Eingabe per Hand)
  162.  
  163. ALL
  164. ===
  165.  
  166. Steht fr: maketic checktic clear makeupl
  167.  
  168. Das Progr. geht jeden Parameter durch und der erste der nicht bekannt ist wird als 
  169. Pfad zum MAKEUPL.INF angenommen. Die Reihenfolge spielt keine Rolle auch grož 
  170. klein ist egal.
  171.  
  172. Wird das Prog. ohne (oder nur mit dem Pfad zum INF) Parameter aufgerufen, dann 
  173. wird nur MAKEUPL angenommen, also so wie bisher. 
  174.  
  175.  
  176. Ich wrde mich ber eine kurze Info ber den Einsatz oder evtl. Probleme 
  177. freuen. Dazu bitte eine Mail an Volker Keck @ BL.
  178.  
  179. Tschž Volker
  180.  
  181. PS: Wer Bock hat, kann gerne die Doku verbessern, denn das ist wirklich das 
  182. was ich am liebsten mache. ;->>
  183.  
  184. Erstellt von fm@s3
  185.  
  186. Doku zum Format der JAMES-TICs
  187. ------------------------------
  188.  
  189. TIC-Files kommen eigentlich aus dem FIDO. Es sind kleine ASCII-Dateien, die
  190. zusammen mit den Programmarchiven ber das Netz verteilt werden. In ihnen
  191. steht die Beschreibung der Programmarchive. Da im Programmteil der MAUS
  192. mehr Kriterien m”glich sind ist das JAMES-Ticfile Format um ein paar Dinge
  193. erweitert worden. Es lassen sich damit z.B. Uploads in die MAUS per
  194. MausTausch realisieren und auch z.B. Filenetze zwischen mehreren Mausboxen.
  195.  
  196. Es geht los:
  197. Der Dateiname des TIC ist egal, Hauptsache Endung .TIC. Praktischerweise
  198. w„hlt man den Namen des Programmarchives und h„ngt die Endung 'TIC' an.
  199.  
  200. Die Token, also die 'Stichworte' auf die James reagiert sind nicht Case-sens,
  201. es kann also 'GRUPPE' genauso stehen wie 'Gruppe'.
  202.  
  203. In einem James-TIC k”nnen die Beschreibungen mehrere Programmarchive stehen,
  204. jeder Beschreibungsblock beginnt dann mit 'AREA JAMESTIC'.
  205.  
  206.  
  207. AREA JAMESTIC [Maus]  der Token JAMESTIC ist zwingend, die MAUS darf
  208.                       dahinter stehen. James erkennt daran das erweiterte
  209.                       Format. AREA JAMESTIC ist also erster Token
  210.                       eines Beschreibungsblocks.
  211.  
  212. DESC                  Bei FIDO-Tics steht *hinter* diese mToken die
  213.                       Beschreibung, in James-TIC folgt die Beschreibung ab der
  214.                       *n„chsten* Zeile (s.u.)
  215.  
  216. ORIGIN name           Name des Uploaders, also volle Mausadresse.
  217.  
  218. FILE filename         der Dateiname des Archivs das eingespielt werden soll
  219.  
  220. FROM                  unbenutzt, Uploader wird aus ORIGIN genommen.
  221.  
  222. REPLACES filename     Falls <filename> im selben Programmteil mit dem selben
  223.                       Betriebssystem existiert wird filename gel”scht.
  224.  
  225. Sobald AREA JAMESTIC gefunden wurde sind folgende zusaetzliche
  226. Token erlaubt:
  227.  
  228. DESC                                    Block mit der Beschreibung
  229. Beschreibungszeile 1                    Es werden 5 Zeile gelesen,
  230. ...                                     maximal jedoch bis ENDDESC
  231. Beschreibungszeile 5
  232. ENDDESC
  233.  
  234. GRUPPE   Falls in einen Gruppenprogrammteil oder in den PPT eingespielt
  235.          werden soll folgt der Gruppenname oder die Mausadresse fr
  236.          den PPT, mehrere Empf„nger im PPT trennt man durch Komma. Wichtig:
  237.          Empf„nger im PPT *mit* Boxkrzel angeben:
  238.          GRUPPE Fritz Meyer @ S3, Uwe Schlenther @ S3
  239.          Kann also bei ™PT entfallen.
  240.  
  241. PKRITS   Durch Blanks getrennt der Reihe nach die Indizes fuer:
  242.          Betriebssystem
  243.          Programmtyp
  244.          Copyright
  245.          Quelltext
  246.          (Indizes wie online in der MAUS: 1 DOS etc. eine Liste findet sich
  247.          im Anhang)
  248.  
  249.  
  250. Beispiele:
  251.  
  252. (die Kommentare drfen da aber eigentlich *nicht* stehen
  253.  
  254. Einspielen in den GPT ct
  255. -------------------------
  256.  
  257. Area JAMESTIC S3
  258. Origin Frithard Meyer-zu-Uptrup @ S3
  259. File CT9403.ZIP
  260. Desc
  261. Die Listings der c't 3/94:
  262. Joker im Spiel (PC), Haufen im Keller (Mac),
  263. Wider den Schnickschnack (PC), Alles unter Kontrolle (Mac),
  264. Objektwelt (PC)
  265. Enddesc
  266. Gruppe ct
  267. Pkrits 0 30 0 0
  268.  
  269.  
  270. James-TIC zum Einspielen in den PPT
  271. -----------------------------------
  272.  
  273. Area JAMESTIC S3
  274. Origin Hans Wurst @ S3
  275. File TEST.ZIP
  276. Desc
  277. Hallo, hier ist eine ganz tolle neue Datei!
  278. Wurde automatisch in den PPT eingespielt
  279. Enddesc
  280. Gruppe Fritz Meyer @ S3, Uwe Schlenther @ S3, Herbert Mller @ S3
  281. Replaces TEST.ZIP
  282.  
  283. Hier mal ein Jamestic mit mehreren Files:
  284. -----------------------------------------
  285.  
  286. Area JAMESTIC S3
  287. Origin Uwe Schlenther @ S3
  288. From 2:246/20
  289. File am@zw.jpg
  290. Desc
  291. Sysoptreffen 1993 Stuttgart:
  292. am@zw
  293. Bilder von Ralph Bhr @ SB
  294. Enddesc
  295. Gruppe TOPS.93
  296. Pkrits 0 15 0 0
  297.  
  298. Area JAMESTIC S3
  299. Origin Uwe Schlenther @ S3
  300. From 2:246/20
  301. File band1.jpg
  302. Desc
  303. Sysoptreffen 1993 Stuttgart:
  304. Die S3-Band
  305. Bilder von Ralph Bhr @ SB
  306. Enddesc
  307. Gruppe TOPS.93
  308. Pkrits 0 15 0 0
  309.  
  310. Area JAMESTIC S3
  311. Origin Uwe Schlenther @ S3
  312. From 2:246/20
  313. File band2.jpg
  314. Desc
  315. Sysoptreffen 1993 Stuttgart:
  316. Die S3-Band
  317. Bilder von Ralph Bhr @ SB
  318. Enddesc
  319. Gruppe TOPS.93
  320. Pkrits 0 15 0 0
  321.  
  322.  
  323. Anhang
  324. ------
  325.  
  326. Kriterien im Programmteil, Stand 10/94
  327. --------------------------------------
  328.  
  329. Betriebssystem
  330.                0  Sonstige
  331.                1  DOS
  332.                2  OS/2
  333.                3  Windows
  334.                4  ST TOS
  335.                5  Amiga
  336.                6  Macintosh
  337.                7  Unix
  338. Programmtyp    
  339.                0   Sonstiges
  340.  
  341.                1   Utility allgemein
  342.                2   Disk-Utility
  343.                3   Systemdiagnose
  344.                4   Virenfinder /-t”ter
  345.                5   Drucker-Utility
  346.                6   Packer
  347.                7   Datenfernbertragung
  348.                8   Terminalprogramm
  349.                9   Fileliste
  350.                10  MausTauschprogramm
  351.                11  Filetransferprotokoll
  352.                12  Grafik
  353.                13  CAD
  354.                14  Malprogramm
  355.                15  Bild [GIF PCX EPS ...]
  356.                16  Anwendungen
  357.                17  Textverarbeitung/Editor
  358.                18  Datenbank
  359.                19  Business-Software
  360.                20  Benutzeroberfl„che
  361.                21  Betriebssystem
  362.                22  Treiber
  363.                23  Font
  364.                24  Spiel / Unterhaltung
  365.                25  Denkspiel
  366.                26  Simulation
  367.                27  Spielerei / Juxprogramm
  368.                28  Actionspiel
  369.                29  Adventure
  370.                30  Programmier-Tool
  371.                31  Soundfile
  372. Source         
  373.                0  Kein Quelltext
  374.                1  Assembler
  375.                2  Pascal
  376.                3  C
  377.                4  C++
  378.                5  Modula-2
  379.                6  Basic
  380.                7  Textfile
  381.                8  TeX
  382.                9  Sonstiges
  383.  
  384. Copyright 
  385.                0  Public Domain
  386.                1  Freeware
  387.                2  Shareware
  388.                3  Shareware-Vollversion
  389.                4  Shareware-Eingeschr„nkt
  390.                5  GNU-Lizenz
  391.                6  Demoversion
  392.  
  393.